home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / info-service / gopher / Unix / gateways / techinfo / gophtech / INSTALL < prev    next >
Encoding:
Text File  |  1993-03-01  |  3.3 KB  |  102 lines
  1.  
  2.  
  3. ********** How to install the gopher-techinfo gateway **********
  4.  
  5. 1) Edit the file "gw.h" and change any #defines that need to
  6.    be changed.
  7.  
  8.    DEBUGLOG        the filename where the gateway will write
  9.             debugging and statistics information.  The
  10.             gateway runs as userid "daemon", so make sure
  11.             daemon has write permission on this file.  If
  12.             necessary, create an empty file and change
  13.             owner to daemon.
  14.  
  15.    MSGFILE        the filename of the "About this Gopher" item.
  16.             The gateway will read this file and send it to
  17.             the Gopher client.  See the file "MSG" for an
  18.             example.  DAEMON needs read permission for
  19.             this file.
  20.  
  21.    LOCALTI_SERVER    the domain name of the local Techinfo server
  22.             The gateway connects to this server when a
  23.             gopher sends "" as the token.  At UPENN, the
  24.             name is penninfo-srv.upenn.edu.
  25.  
  26.             if there's no local TechInfo, change this line to:
  27. #define LOCALTI_SERVER ""  /* there is no local techinfo */
  28.  
  29.    LOCALTI_PORT        the port that the local TechInfo server
  30.             listens at (ignored if LOCALTI_SERVER is "").
  31.  
  32.    LOCALTI_MAINMENU    the nodeid of the top menu of the local
  33.             Techinfo server (ignored if LOCALTI_SERVER is
  34.             "").  You can pick any menu's nodeid.
  35.  
  36.  
  37.    TISERVERS_HOST    the domain name of the host that knows the
  38.             list of TechInfo servers.
  39.  
  40.    TISERVERS_PORT    the port at which the TISERVERS_HOST server
  41.             listens.
  42.  
  43.    LOCALGOPHTITLE    the name(title) of a gopher server.  If
  44.             you don't want to point to any, set it to
  45.             "".  If you leave it blank, then
  46.             LOCALGOPHERSERVER, LOCALGOPHERPORT, and
  47.             LOCALGOPHERPATH are ignored.  Otherwise,
  48.             the gateway sends them along with the
  49.             title as part of the root menu.  The
  50.             local gopher file type must be a Gopher
  51.             Directory file (gopher type 1).  For the
  52.             local gopher server at UPENN, these three
  53.             values should be "gopher.upenn.edu", port
  54.             "70", and "".
  55.  
  56.    WAIS            #define this flag if you want each menu
  57.             to contain an item for full text wais
  58.             searching.
  59.  
  60.    SOURCES_MSGFILE    Name of file that describes how to view the
  61.             Gopher path & use it to see the TechInfo Source.
  62.  
  63.    SOURCES_NODEID    Nodeid of the TechInfo document at LOCALTI_SERVER.
  64.             Ignored if there is no LOCALTI_SERVER.
  65.  
  66.  
  67.  
  68. 2) Compile the gateway code:
  69.     make -k
  70.  
  71. 3) Move the executable to /usr/local/bin or whatever is the convention
  72.    on your operating system.
  73.  
  74. 4) Edit /etc/services and add the gopher service to it, if it's not
  75.    already there:
  76. gophtech    71/tcp
  77.  
  78. 5) Edit /etc/inetd.conf and add the gophtech gateway to it.  The
  79.    gateway program takes two arguments: the domain name of the
  80.    localhost, and the port at which the gateway is listening.
  81.  
  82. Example:
  83.  
  84. gophtech stream tcp nowait /usr/local/bin/gophtech gophtech gopher-penninfo.upenn.edu gophtech
  85.  
  86. 6) Send a HUP to the inetd daemon so that it will re-read inetd.conf.
  87.  
  88. 7) Copy MSG and PROVIDERS to the right directory.
  89.  
  90.    Give DAEMON the permission to read these files, since the gateway
  91.    runs as userid DAEMON.  chmod ugo+r .../{MSG,PROVIDERS}
  92.  
  93. 8) Define the domain name (or a CNAME) in the domain name system for
  94.    your site.  In the example I used above, it would be
  95.    gopher-penninfo.upenn.edu.
  96.  
  97. 9) The MSG file refers to a mail alias to report bugs with
  98.    the gophtech gateway (gopher-penninfo@dccs.upenn.edu).  Please
  99.    create the mail alias and be sure that at least murphy@dccs.upenn.edu
  100.    is on the list.  I don't know who, if anyone else, should be on
  101.    it.
  102.